<!--
  This file is a part of the open-eBackup project.
  This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
  If a copy of the MPL was not distributed with this file, You can obtain one at
  http://mozilla.org/MPL/2.0/.
  
  Copyright (c) [2024] Huawei Technologies Co.,Ltd.
  
  THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
  EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
  MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
  -->

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en-us" xml:lang="en-us">
 <head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="DC.Type" content="topic">
  <meta name="DC.Title" content="Restoring GoldenDB">
  <meta name="product" content="">
  <meta name="DC.Relation" scheme="URI" content="en-us_topic_0000002200155317.html">
  <meta name="prodname" content="">
  <meta name="version" content="">
  <meta name="brand" content="">
  <meta name="DC.Publisher" content="20250306">
  <meta name="prodname" content="csbs">
  <meta name="documenttype" content="usermanual">
  <meta name="DC.Format" content="XHTML">
  <meta name="DC.Identifier" content="EN-US_TOPIC_0000002200155277">
  <meta name="DC.Language" content="en-us">
  <link rel="stylesheet" type="text/css" href="public_sys-resources/commonltr.css">
  <title>Restoring GoldenDB</title>
 </head>
 <body style="clear:both; padding-left:10px; padding-top:5px; padding-right:5px; padding-bottom:5px">
  <a name="EN-US_TOPIC_0000002200155277"></a><a name="EN-US_TOPIC_0000002200155277"></a>
  <h1 class="topictitle1">Restoring GoldenDB</h1>
  <div>
   <p>This section describes how to use copies to restore a GoldenDB instance that has been backed up to the original or a different host.</p>
   <div class="section">
    <h4 class="sectiontitle">Prerequisites</h4>
    <p>Before restoration, ensure that the remaining space of the data directory at the target location for restoration is greater than the size of the copy used for restoration before reduction. Otherwise, restoration will fail.</p>
   </div>
   <div class="section">
    <h4 class="sectiontitle">Procedure</h4>
    <ol>
     <li><span>Choose <span class="uicontrol" id="EN-US_TOPIC_0000002200155277__en-us_topic_0000002199964685_uicontrol102561512112712"><b><span id="EN-US_TOPIC_0000002200155277__en-us_topic_0000002199964685_text425611128274"><strong>Explore</strong></span> &gt; <span id="EN-US_TOPIC_0000002200155277__en-us_topic_0000002199964685_text7256181216275"><strong>Copy Data</strong></span> &gt; <span id="EN-US_TOPIC_0000002200155277__en-us_topic_0000002199964685_text6155173314912"><strong>Databases</strong></span> &gt; <span id="EN-US_TOPIC_0000002200155277__en-us_topic_0000002199964685_text193501929192917"><strong>GoldenDB</strong></span></b></span>.</span></li>
     <li><span>Search for copies by resource or copy.</span><p></p>
      <ul>
       <li>On the <span class="uicontrol"><b><span><strong>Resources</strong></span></b></span> tab page, find the instance to be restored based on the name and click the instance name.</li>
       <li>On the <span class="uicontrol"><b>Copies</b></span> tab page, find the target copy based on the copy information and choose <span class="uicontrol"><b><span><strong>More</strong></span> &gt; <span><strong>Restore</strong></span></b></span> in the row where the copy is located.</li>
      </ul> <p>This section uses the database resource dimension as an example to describe the related operations.</p> <p></p></li>
     <li><span>Specify a copy or a point in time for restoration.</span><p></p><p>You can specify a copy or any point in time between two copies for restoration.</p>
      <ul>
       <li>Specify a copy for restoration.
        <ol type="a">
         <li>Select the year, month, and day in sequence to find the copy.<p>If <span><img src="en-us_image_0000002214668305.png"></span> is displayed under a month or date, copies exist in the month or on the date.</p></li>
         <li>On the copy data page, click <span><img src="en-us_image_0000002179302374.png"></span>. In the row of the target copy, choose <span class="uicontrol"><b>More &gt; Restore</b></span>.</li>
        </ol></li>
       <li>Specify a point in time for restoration.
        <ol type="a">
         <li>Select the year, month, and day in sequence to find the copy.<p>If <span><img src="en-us_image_0000002214822721.png"></span> is displayed under a month or date, copies exist in the month or on the date.</p></li>
         <li>On the copy data page, click <span><img src="en-us_image_0000002179462098.png"></span>. In the blue part on the timeline, select a copy and choose <span class="uicontrol"><b>More &gt; Restore</b></span>.</li>
        </ol></li>
      </ul> <p></p></li>
     <li><span>In the row of the target copy, choose <span class="uicontrol"><b><span><strong>More</strong></span> &gt; <span><strong>Restore</strong></span></b></span>.</span><p></p><p><a href="#EN-US_TOPIC_0000002200155277__en-us_topic_0000001263614142_table93951625101715">Table 1</a> describes the related parameters.</p>
      <div class="tablenoborder">
       <a name="EN-US_TOPIC_0000002200155277__en-us_topic_0000001263614142_table93951625101715"></a><a name="en-us_topic_0000001263614142_table93951625101715"></a>
       <table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002200155277__en-us_topic_0000001263614142_table93951625101715" frame="border" border="1" rules="all">
        <caption>
         <b>Table 1 </b>Parameters for restoring a GoldenDB instance
        </caption>
        <colgroup>
         <col style="width:32.53%">
         <col style="width:67.47%">
        </colgroup>
        <thead align="left">
         <tr>
          <th align="left" class="cellrowborder" valign="top" width="32.53%" id="mcps1.3.3.2.4.2.2.2.3.1.1"><p>Parameter</p></th>
          <th align="left" class="cellrowborder" valign="top" width="67.47%" id="mcps1.3.3.2.4.2.2.2.3.1.2"><p>Description</p></th>
         </tr>
        </thead>
        <tbody>
         <tr>
          <td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.3.2.4.2.2.2.3.1.1 "><p><span><strong>Restore To</strong></span></p></td>
          <td class="cellrowborder" valign="top" width="67.47%" headers="mcps1.3.3.2.4.2.2.2.3.1.2 "><p>Select either <span class="uicontrol"><b><span><strong>Original location</strong></span></b></span> or <span class="uicontrol"><b><span><strong>New location</strong></span></b></span>.</p>
           <div class="note">
            <span class="notetitle"> NOTE: </span>
            <div class="notebody">
             <p>If you select <strong>New location</strong>, you are advised to select the location with the same number of shards for restoration. If the number of shards is inconsistent, the restoration may fail.</p>
             <p>To view the shard information:</p>
             <ol type="a">
              <li>Choose <span class="uicontrol"><b><span>Protection</span> &gt; Databases &gt; GoldenDB</b></span>.</li>
              <li>On the <span class="uicontrol"><b>Instance</b></span> tab page, click an instance name.</li>
              <li>In the <span class="uicontrol"><b>Overview &gt; Data Nodes &gt; Owing Shard</b></span> area, view the shard information.</li>
             </ol>
            </div>
           </div></td>
         </tr>
         <tr>
          <td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.3.2.4.2.2.2.3.1.1 "><p><span><strong>Location</strong></span></p></td>
          <td class="cellrowborder" valign="top" width="67.47%" headers="mcps1.3.3.2.4.2.2.2.3.1.2 "><p>If you select <span class="uicontrol"><b><span><strong>Original location</strong></span></b></span>, the target location is displayed by default.</p></td>
         </tr>
         <tr>
          <td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.3.2.4.2.2.2.3.1.1 "><p><strong>Tag</strong></p>
           <div class="note">
            <span class="notetitle"> NOTE: </span>
            <div class="notebody">
             <p>This parameter is available only in 1.6.0 and later versions.</p>
            </div>
           </div></td>
          <td class="cellrowborder" valign="top" width="67.47%" headers="mcps1.3.3.2.4.2.2.2.3.1.2 "><p>If you set <strong>Restore To</strong> to <span class="uicontrol"><b>New location</b></span>, you can filter the resources to be restored by tag.</p></td>
         </tr>
         <tr>
          <td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.3.2.4.2.2.2.3.1.1 "><p><span><strong>Target Cluster</strong></span></p></td>
          <td class="cellrowborder" valign="top" width="67.47%" headers="mcps1.3.3.2.4.2.2.2.3.1.2 "><p><strong><span><strong>New location</strong></span></strong>: Data will be restored to the original cluster by default.</p></td>
         </tr>
         <tr>
          <td class="cellrowborder" valign="top" width="32.53%" headers="mcps1.3.3.2.4.2.2.2.3.1.1 "><p><span><strong>Target Instance</strong></span></p></td>
          <td class="cellrowborder" valign="top" width="67.47%" headers="mcps1.3.3.2.4.2.2.2.3.1.2 "><p><strong><span><strong>New location</strong></span></strong>: Select the target instance for the restoration.</p></td>
         </tr>
        </tbody>
       </table>
      </div> <p></p></li>
     <li><span>Click <span class="uicontrol"><b><span><strong>OK</strong></span></b></span>.</span></li>
    </ol>
   </div>
  </div>
  <div>
   <div class="familylinks">
    <div class="parentlink">
     <strong>Parent topic:</strong> <a href="en-us_topic_0000002200155317.html">Restoration</a>
    </div>
   </div>
  </div>
 </body>
</html>